home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Science / RLaB / help / readb < prev    next >
Text File  |  1994-04-25  |  1KB  |  45 lines

  1. readb:
  2.  
  3. Syntax:    readb ( "filename" )
  4.     readb ( "filename" , L )
  5.  
  6. Description:
  7.  
  8.     readb() reads the file identified by the "filename". The file
  9.     is opened with read access, and all of the contents are read.
  10.     The file identified by the 1st argument must contain data that
  11.     is in RLaB binary format.  The entities in the file are
  12.     installed in the global symbol table, overwriting any existing
  13.     entities. Upon completion the file is closed.
  14.  
  15.     Example:
  16.  
  17.         readb ("bunch_of_data_in_a_file");
  18.  
  19.     The second form of the read function allows the data in the
  20.     file to be read into a list variable L. The
  21.     global-symbol-table is untouched (except for L).
  22.  
  23.     Example:
  24.  
  25.         readb ("bunch_of_data", X);
  26.  
  27.     The contents of the file `bunch_of_data' are read and stored
  28.     in the list variable X. Except for the creation/modification
  29.     of the variable X, the global-symbol-table is unchanged.
  30.  
  31.     Readb will read numeric matrices written by MATLAB's save
  32.     command. Readb will not read MATLAB text matrices, or sparse
  33.     matrices, or matrices written with reduced precision (integer
  34.     format). Furthermore readb will not read Cray, or VAX
  35.     binaries. ReadB will read big and little endian binaries -
  36.     this includes binaries written from PCs, DEC Risc, Macintosh,
  37.     Sun, and Apollo.
  38.  
  39. See Also: FILES, close, writeb
  40.  
  41. Future Enhancements:
  42.  
  43.     readb() should have the option to list the contents of a file
  44.     without actually reading them into the symbol table. 
  45.